3D Graphics Programming with QuickDraw 3D 1.5.4

Compiling Your Application

In order for your application's code to work correctly with the code contained in the QuickDraw 3D shared library, you need to ensure that you use the same compiler settings that were used to compile the QuickDraw 3D shared library. Otherwise, it's possible for QuickDraw 3D to misinterpret information you pass to it. For example, all the enumerated constants defined by QuickDraw 3D are of the int data type, where an int value is 4 bytes. If your application passes a value of some other size or type for one of those constants, it's likely that QuickDraw 3D will not correctly interpret that value. Accordingly, if the default setting of your compiler does not make enumerated constants to be of type int , you must override that default setting, typically by including pragma directives in your source code or by using an appropriate compiler option.

There are currently three important compiler settings:

Enumerated constants are of the int data type.
Elements of type char or short that are contained in an array that is contained in a structure may be aligned on non-longword boundaries.
Fields in a structure that contain pointers or data of type long , float , or double are aligned on longword boundaries.

The interface file QD3D.h contains compiler pragmas for several popular C compilers. For example, QD3D.h contains this line for the PPCC compiler, specifying field alignment on longword boundaries for pointers or data of type long , float , or double :



 
#pragma options align=power

Some compilers might not provide pragmas for the three important compiler settings listed above. For example, the PPCC compiler does not currently provide a pragma for setting the size of enumerated constants. PPCC does however support the -enums compiler option, which you can use to set the size of a enumerated constants.

Consult the documentation for your compiler to determine how to specify the size of enumerated constants and to configure structure field alignment so as to conform to the settings of QuickDraw 3D.